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Atari Computer Enthusiasts (N.S.W.) 


Atari Computer Enthusiasts (N.S.W.) is an independant, non-profit computer users’ group 
loosely affiliated with Atari Computer Enthusiasts in the U.S.A, We have no connections 
with ATARI, Inc. or their Australian distributors, Futuretronics Australia Pty Ltd, 


Qur aims include promotion of the ATARI 400/800 Home Computer System} instructing both 
beginners and advanced users in programming techniques} exchanging hints, tips and ideas 
amongst members and generally enjoying ourselves, 


Meetings are held at 4.0 P.M. sharp on the first Monday of every month (or the second 
Monday if it clashes with a public holiday) at the offices of! 

LP. Sharp Associates 

Sth Floor, 

Carlton Centre, 

25 Elizabeth Street, 

Sydney, 

(between King Street and Martin Place) 
Membership to A,C.E.(N.S,W.) is $15 joining fee and $15 annual subscription (or $10 joining 
fee and $10 annual subscription for students under 18 and still at school), 


Subscriptions or postal enquiries may be directed to! 
Atari Computer Enthusiasts (N.S,W,) 
78 Ayres Road, 
St, Ives, 
NLS.W. 92075 


Phone enquiries! 
Garry Francis! 2-09732 Ext 254 (Work) or 789-1397 (Home) 
Ron Baxter! 81-2388 (Home) 
Paul Phillips! 449-6254 (Home) 


Meeting Dates for Remainder of 1982 


Znd August 

&th September 

11th October (due to Eight-Hour Day Holiday) 
ist November (4.G.M,) 

éth December 


New Members 


Steven Marcus, Waverley 
Paul Milewski, Chatswood 
Patrick Munn, Harbord 
Gregg Ramsey, Coogee 
Tony Reeve, Frenchs Forest 
Shaun Smith, Tarago 


From The Editors 


Two months is sometimes long enough for many things to change. In the two months since 
INSIDE INFO No. 1, we’ve seen two dramatic changes which should greatly alter the 
appearance of our fledgling publication. 


Firstly, Garry has acquired a printer and word processor so that much of the material for 
this issue has been belted out on his ATARI, which is quite appropriate really. This means 
that he will be doing most of the work in preparing future issues, 


Secondly, we have had the good fortune of having the printing costs absorbed by one of our 
members, on the condition that we allow him to place an advertisement in each issue. Now 
you may not be immediately impressed by the presence of advertising because it may seem to 
detract from the independence of A.C.E.(N.S.W.), so let me bore you with a few figures. The 
printing cost for INSIDE INFO No, 1 was $45 (despite a generous discount) from a fast-print 
shop. Even though the print quality was poor, we would be looking at an annual printing cost 
of about $270, In addition to this, we need money for Letraset, postage, envelopes and the 
like. At present we only have 71 financial members, so the annual income from subscriptions 
is only about $300, (The one-time membership fee cannot be used for the newsletter.) This 
means that INSIDE INFO will soak up all our funds, 


If income from advertising can offset the printing costs and other overheads, then I’m sure 
you'll all agree that we are in a much healthier situation. In fact, this should leave the 
group with more money for other projects such as the purchase of software from A.C.E. in the 
States, Please let us know how you feel about the changes, 


- Ron Baxter 


I must confess that I didn’t really expect to see INSIDE INFO No, 2, because I thought 
everybody would be too lazy to put in the effort required to prepare articles. I certainly 
underestimated you! We’ve had a fantastic response from some members, so things look 
promising for the future. We'll probably be able to maintain a bi-monthly output, but we 
still need lots of articles for future issues, especially programs - and don’t forget our 
competition for the best article (or most consistent author) this year. 


There is quite an interesting variety of articles this issue and more importantly, more 
program listings - every one of whichis really worth the effort of feeding to your ATARI. 
We have the much requested introduction to the ATARI’s hardware, as well as a discussion of 
the differences between the NTSC and PAL versions of the computer. Gregg Ramsey 
provides the first of a possibly regular series which will explore some of the ATARI’s lesser 
known graphics capabilities. In this issue, he tells you how to get text onto a GRAPHICS & 
screen and gives a neat demo in ANTIC mode 4. Peter Stanhope begins an ongoing series on 
Copyright law in Australia, with future issues discussing implications to the computer user 
(software pirates take note). There’s also a program to draw fascinating spiral patterns, a 
discussion of the TRAP statement and a nifty utility to help you select colours for use with 
GRAPHICS 0 or &, 


Next issue (i.e, October) will be a special issue on the GTIA chip. We will unveil the mystery 
behind GTIA and explain how to use the extra graphics modes that it provides. We want lots 
of demo programs, so if you’ve written anything using GRAPHICS 9, 10 or 11, then get it to 
us on or before the September meeting. Brenton Vettoretti is currently in the United States 
and has promised us a full report on the latest happenings over there. This should also be in 
the next issue, , 


As the 4th issue (i.e, December) should be released just before Christmas, the theme for that 
issue will most appropriately be games, So git workin’ on them thar super games programs!!! 


- Garry Francis 


COPYRIGHT LAW - ITS USE AND ABUSE 


by Peter Stanhope 


Copyright law is an extremely complicated and often abstract law. It does however. have 
some Clearly defined principles and it is these that I will be discussing, 


THE BASIC RULES 
1, In order for material to be eligible for copyright protection, it must fall into one of the- 
following categories} 
a) Literary works 
b) Dramatic works 
c) Musical works 
d) Artistic works 
e) Sound recordings 
f) Films 
g) T.V. broadcasts 
h) Radio broadcasts 
i) Published editions of a-d above 
The first four are described as “Works" and the others as "Subject Matters", 


Z. Copyright subsists for a defined period of time depending upon the category in which it 
falls, 


3. The rights entitled to the copyright holder are only thase which prevent other people from 
daing certain things defined by law to the copyright holder’s material, 


4, There are some things which (by law) you are allowed to do, These are! 
a) Fair dealing 
b) Less than substantial extracts 
c) Use by M.P,’s 


s+ In the case of "Works", the author, composer or artist owns the First Rights to the work. 
These First Rights may be passed on by the person who owns them. In the case of 
"Subject Matters", the maker, publisher or producer owns the First Rights and again they 
may be passed on by the owner of the Rights, 


&, There is no copyright on ideas - only on the way in which they are expressed on some form 
of permanent media, There are laws that limit the use of ideas, These are called the Law 
of Passing Off or the Law of Confidances. Of course, there are Patent Laws and 
Trademark Laws but, they are separate laws. 


7. To obtain copyright protection, the ideas must be in material form. That is to say, they 
must be on a permanent medium of some sort, 


€. The material must be original!!! 


?, The material does not have to be published to obtain copyright protection, nor does it have 
to be registered anywhere, 


10, The author ar maker must be a citizen of one of the countries that are party to either or 
both of the International Copyright Agreements, . 


11, Copyright is owned independantly of the matter on which it appears. To gain copyright 
protection you need only put! 
a) The date of the original copy or edition 
b) The International Copyright symbal (C) 
c) Your name (in full) 


(More next newsletter) 
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WHAT MAKES IT TICK? 
A Brief Description of ATARI’s Hardware 


by Garry Francis 


Let’s take a look at the innards of the ATARI 400/300 Home Computer System, as the 
internal layout is very different from other personal computers. The heart of the ATARI is 
the Synertek 6502 microprocessor, which is also used by the Apple, Commodore PET, 
Commodore VIC, Ohio Scientific Instruments and several single board computers, Other 
hardware includes a Peripheral Interface Adapter (PIA) and several Medium Scale Integrated 
circuits (MSI’s) for address decoding and data bus buffering. 


Memory consists of a 10k Operating System (OS) in a Read Only Memory (ROM) module, 
optional plug-in software (such as BASIC or Star Raiders) in ROM cartridges and a variable 
amount of Random Access Memory (RAM), I won’t bore you with descriptions of all the above 
as it has been covered many times before in a multitude of computer books and magazines, 


Here is where the similarities between the ATARI and other personal computers end. In 
addition to the above, the ATARI has 3 custom-designed, special purpose Large Scale 
Integrated circuits (LSI’s) known as ANTIC, GTIA and POKEY. Each of these is almost as 
big in terms of silicon area as the 6502 itself, A great deal of power has been built into 
these chips and mastering the ATARI is primarily a matter of mastering these 3 chips. In 
fact, they have capabilities not supported by BASIC or the Operating System, notably = extra 
text/character modes, 2 extra bit-mapped graphics modes, extra sound generation 
capabilities and player-missile graphics. Nearly all the abilities of the hardware can be 
used from BASIC, but to utilise them to their maximum, it is sometimes necessary to use 
machine language or at least machine language subroutines from within a BASIC program, 
Let’s take a brief look at each of the LSI’s, 


ANTIC 54272-54287 [$D400-$D40F] 

ANTIC is dedicated to the screen display. It is a true microprocessor with its own 
instruction set, program (called the display list) and datas The Operating System writes a 
new display list every time you carry out a GRAPHICS command from BASIC (like GRAPHICS 
0 or GRAPHICS 7), However, if you modify the display list or write a new one, you can 
access the extra graphics modes or arrange your screen into any format you wish. You could, 
for example, have a heading in GRAPHICS 2, a subheading in GRAPHICS 1, a 4 colour picture 
in GRAPHICS 7 and same notes at the bottom in GRAPHICS 0. The display list is also used 
to enable Display List Interrupts (DLI’s), horizontal and vertical fine scrolling and page 
flipping, ANTIC’s other duties include Non-Maskable Interrupt (NMI) control, character 
control (i.e, whether normal, inverse, vertical reflect or blanking) and Direct Memory Access 
(DMA) control, (DMA is the process of temporarily "turning off" the 6502 while ANTIC 
fetches display list instructions, display data or player-missile graphics data.) It also 
keeps track of the player-missile base address (i.e, where player-missile data is stored), 
light pen position registers, TV scan line counter and the character base address, (Changing 
the base address allows you to have one or more user-defined character sets), 


GTIA 53248-53279 [$D000-$D01F] 

GTIA is the Television Interface Adaptor. It is the chip responsible for converting digital 
commands from ANTIC into the analog signal that goes to the TV. It also handles the 
ATARI’‘s legendary player-missile graphics. Player-missile graphics is a method of 
manipulating bit-mapped objects through memory so that the objects appear on the screen 
independantly of the normal display. GTIA supports 4 objects called "players" which are 8 
bits wide and any height, Each player has a "missile" associated withit. These are 2 bits 
wide and any height and may optionally be combined to forma Sth player. GTIA controls 
size, horizontal position and the graphics registers associated with all the players and 
missiles, as well as collision detection and priority control {to determine which object or 
background to display in case of overlapping) It also reads the joystick triggers, console 
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keys and can determine whether the system is NTSC or PAL (see "NTSC vs PAL" elsewhere in 
this issue). 


POKEY 22760-33772 [$D200-¢D20F] 

POKEY is an acronym for POrt and KEYboard, It is a digital Input/Output (1/0) chip which 
handles the serial communications port, keyboard scan and control, sound generation and 
control, system timers, maskable-interrupt (RQ) control, random number generation, scanning 
the paddles and converting the information from analog form digital. 


PIA 54016-54019 [$D200-$D303] 

Although not a custom chip, the Peripheral Interface Adaptor (PIA) also deserves a mention. 
It is responsible for peripheral control and interrupt lines (e.g. turning on and off the 
cassette motor) and the controller ports, The controller ports are normally used far input, 
such as from joysticks, but may also be used for output. Macrotronics have taken advantage 
of this feature to release a printer cable which bypasses the need for an Interface Module, 


This is obviously only a very brief introduction, Many of the above topics could fill a year’s 
worth of INSIDE INFO and still not be adequately covered, If you’ve written programs 
incorporating any of the ATARI’s special features or have any specific questions, then send 
them in for inclusion in future issues (you may even win the super-duper prize for best 
author of the year +. see last issue for details), 


*** 


SPIRALS 


by Ron Baxter 


Spiral patterns can be formed by drawing a series of polygons inside each other, The first 
polygon can be drawn by connecting points that are equally spaced around acircle. We 
therefore need to start with a formula for a circles The following small program 
demonstrates this, 

10 GRAFHICS 24:COLOR 1tFLOT 1604+90,95 

20 FOR TH=0 TO 6.3 STEF 0.3 

30 DRAWTO 160+90«COS(TH) ,95+90%SINCTH) 

40 NEXT TH 

“0 GOTO 30 


Now you may be wondering where some of the numbers in this program came from, In 
GRAPHICS € with no text window there are 320 pixels across the screen and 192 down. So 
the values 160 and 95 have been chosen as the X and Y co-ordinates for the centre of the 
circle, The value of 70 has been used as the radius. This leaves the value of 4.3 to be 
explained. Well, it turns out to be roughly twice Pi (where Pi=3.14159...). Now if the step 
size in the above program was larger, the straight line segments would become more visible 
and the circle would look more like a polygon. To get a regular polygon with N sides, the 
step size needs to be Z¥PI/N, 


The next step in forming the spiral is to draw another N-sided polygon slightly smaller than 
the first and rotated until its corners just touch the outer polygon, The corners of the new 
polygon can be found by moving a fraction of the distance along the sides of the outer 
polygon. (The program below moves 1/10th of the length of a side.) If the co-ordinates for 
one side of the outer polygon are X(0),¥(0) and X(1),Y(1), then the point 1/10th of the way 
back from the X(1) end is given by! 

XeXCLI—-CXC19-X0009/10 

FST CLI=CV 013-7009) 710 


Now all that remains to be done is to decide when to stop. The program here simply stops 
when the length of the side gets sufficiently small. 
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1 REM $244444445435342 34 HH 

Z REM F SPIRALS + 

3 REM # by Ror Baxter $ 

4 REM # Published by Atari Computer 4 

a REM 4 Erithusiasts (N.S+H,) 4 

& REM # August 1982 3 

7 REM 3494444544444 HHH BE 

100 GRAFHICS Z4:COLOR 1:DIM X(10),¥(40) 
110 PI=3.14159X0=140 YO=953R=95 

120 SMALL=20:REM stop when side gets this short 
130 MOVE=1/10°REM move along side for this fraction of its length 
200 N=INT(RND(0)*8)+3 

210 FOR I=1 TON 

220 XCI)=XO0+RXSIN(2¥PIXI/N) 

230 Y¥(T)=YO+RXCOS(2*PIXT/N) 

240 NEXT I 

200 C=INT(RND(0)*254) {FOKE 710,C3POKE 712,C 
260 C=C+8tIF C>Z55 THEN C=0-256 

270 FOKE 709,CtFOKE 77,0 

280 PRINT #6;CHR$(125) 

290 XC(Q)=X(N)SYCOD=Y(ND SPLOT X00), YCO) 
300 SIDE=SQR¢(XC1)-X (0) 424 CY (1)-¥ (0) 42) 
310 FOR I=1 TON 

320 SOUND 0,SIDE,10,8:DRAWTO X(I),Y(I) 
330 SOUND 0,0,0,0 

340 NEXT I 

350 IF SIDE<SMALL THEN 200 

360 FOR I=1 TO N 

370 X(T)=X(1)-(X(1)-X (1-1) MOVE 

380 Y(T)=¥(1)-(¥ (1)-¥ (1-1) XMOVE 

390 NEXT I 

400 GOTO 290 





TRAP 
by Paul Phillips 


At the June meeting, I gave a talk on programming, use of the TRAP statement in BASIC and 
a few other topics, In this article, I want to summarise some of what was said about TRAP, 


The TRAP statement is one of the most useful and powerful tools provided in ATARI BASIC 
- if it is used properly and with care. The idea behind the TRAP statement is fairly simple. 
If you set a TRAP in a program and an error is encountered, control is passed to the line 
number specified by the TRAP statement. This means that you can prevent your programs 
from "bombing" by forcing the computer to take specific action instead of printing an error 
message and stopping execution. Although this can be done without a TRAP statement, it is 
much more difficult to do, You have to write code to specifically check whether an error will 
occur and you have to be sure to cover all possible errors, Why not let the computer do it for 
you ~ that’s what TRAP is for? Your code will be simpler and your programs will run faster, 


The TRAP statement is most useful when your program is accepting or using input from the 
user, because this is when you don’t have total control over what information the computer is 
working with. For example, if you are accepting joystick input in order to move an object on 
the screen, you have to make sure that you don’t plot out of range. If you are asking the 
user fay numeric data via the INPUT statement, you have to ensure that he can only enter 
numeric data, as character data will cause the program to crash, In these and similar cases, 
the TRAP statement can make life much easier for you. [But life wasn’t meant to be easy - 
Ed] 


To use the TRAP statement, insert a line such ase. 
10 TRAF 1000 

before the section of code that needs to be checked for errors. In example, if any error is 
encountered after the TRAP statement, the program will be directed to line 1000 and will 
continue execution at that point. You can print a message or take some suitable action, and 
then return the program to the original section of code, If you PEEK (195), you can get the 
number of the error that occurred and take specific action for that particular error, but in 
most cases you will find that you know what errors can occur at a specific point in the 
program, and you will not need to check the error number, 


The TRAP is removed each time an error is encountered after the TRAP statement has been 
used. You have to reset the TRAP if you want to repeat the section of code where the error 
occured and still be able to TRAP the error if it occurs again. Once the program is past the 
section of code for which you wanted the TRAP in effect, it is important to cancel the TRAP 
by specifying a line number larger than 32767, For examplet 
310 TRAF 40000 

If you don’t cancel the TRAP, you may get strange results later in your program or after 
reverting to direct mode, because a new error will be trapped by the old TRAP statement, 
You may not be able to tell where or why an error occured, even though your program is doing 
strange things, 


Below is an example of a section of code incorporating a TRAP} 
10 TRAF 200 
20 FRINT "INFUT A NUMBERS" $ 
30 INFUT N 
40 FRINT N 
70 TRAF 40000 


+ 


190 END 
200 PRINT "INVALID INFUT. FPLEASE TRY AGAIN." 
210 GOTO 10 
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GRAPHICS 0 COLCUR SELECTOR 
by Garry Francis 


This is one of those programs that didn’t just happen overnight. It sort of "evolved" over a 
period of time as it became necessary to simplify the selection of colours for use with 
GRAPHICS 0, This current version has been completely rewritten from scratch using the 
experience gained from the earlier efforts, There are 2 reasons for including it in INSIDE 
INFO, Firstly, it is an invaluable little utility and secondly, it is a good example of the use 
of named variables in statements such as GOTO, GOSUB and RESTORE. 


Colours in GRAPHICS 0 

In GRAPHICS 0 (and also GRAPHICS 8), you are generally restricted to one and a half 
colours. The background colour is specified by the statement SETCOLOR 
2,HUE,LUMINANCE. HUE must be a number between 0 and 15 and specifies the mixture of 
the red, green and blue constituents of the colour. LUMINANCE refers to the brightness and 
must be an even number between 0 and 14, The hue and luminance together define the colour. 
You therefore have a choice of 128 colours for the background, 


The lettering is controlled in a similar manner using SETCOLOR 1,HUE,LUMINANCE but the 
system ignores the value of HUE and uses the same value as that used for the background, 
If the LUMINANCE values for the lettering and the background are the same, then the 
lettering will appear to be invisible. If this case is ignored, there are still 7 possible 
lettering luminances to each background colour. This gives &9%4 possible 
background/lettering colour combinations altogether! Unfortunately, with that many choices, 
picking the right combination by trial and error can be very frustrating, That’s where this 
program comes in handy, 


Incidentally, a GRAPHICS 0 screen can be made even more colourful by changing the border 
colour and advanced programmers can employ display list interrupts or player-missile 
graphics, but that’s way beyond the scope of this article, 


t ‘ 
Using Named Variables in GOTO, GOSUB, etc, 
One of the most useful of ATARI BASIC’s many features is the ability to use a named 


variable in statements such as GOTO and GOSUB, (This feature is not available with 
Microsoft BASIC, so many attempts have been made to add it using messy machine language 
routines, especially for the Apple.) As this feature is not very well documented, here are 
the general formats? 

lineno GOTO aexp 

lineno GOSUE aexp 

lineno ON...GOTO aexp 

lineno ON...GOSUE sexp 

lineno LIST sexp,aexp 

lineno RESTORE gexp 

lineno TRAF aexp 

lineno IF...THEN GOTO aexp 

lineno IF.+.THEN GOSUB aexp 
In each case, “aexp" is any previously defined variable, constant or arithmetic expression 
which will equate to an integer. The following are typical examples} 

100 GOTO UFDATE 

290 GOSUE SAMFLEx10 

310 RESTORE AxB+C 

“70 TRAF 1000+ERROR 
When used in conjunction with ATARI’s ability to use long variable names, you can use 
descriptive names to create a very readable program. In fact, it becomes almost self 
documenting. 


This technique also has many other advantages. It may be used for random accessing and can 
even be used much more efficiently than string arrays. Oné interesting point is that it 
usually results in fewer lines of code; so your program will probably execute much faster. 
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Further discussion may be found in Bill Wilkinson’s column "Insigit}ATARI" in COMPUTE! 
September and Octaber 1¢81, sa without further elaboration, let’s take a look at the 
GRAPHICS 0 Colour Selector to see this technique in action, 


How To Use The Program 
When you run the program, you will be presented with a screenful of information split into 3 


parts. The bottom part is a menu showing the é6 possible selections open to you. A selection 
is made by simply pressing the relevant key - you don’t have to press RETURN, In fact, if 
you press RETURN or any other invalid key, it will simply be ignored. The top part of the 
screen shows the current SETCOLOR values for the background and the lettering. As you 
may sometimes want to use the equivalent POKE values instead of SETCOLOR values, these 
may be displayed at any time by pressing "P", You may revert back to displaying SETCOLOR 
values by pressing "5". The'screen colours (and hence their values in the display) may be 
changed at any time by pressing "<" to decrease the current value or ">" to increase it. The 
value that you are actually changing depends on the current option. This may be either the 
background hue, background luminance or lettering luminance. The current option is always 
_ indicated in the middle part of the screen and may be changed at any time by pressing "C", 
When the program first starts up, background hue will be the current option, 


This program is simple and fun to use, so play around and experiment with it. When you’ve 
found a suitable colour combination for your application, take note of the values then exit 
the program cleanly and neatly by pressing "Q" for quit, This will return you to BASIC, 


Programming Notes 


The program is structured in a modular fashion with each module starting at line numbers in 
multiples of 1000, Enter the program exactly as shown and don’t change any line numbers or 
the GOTO’s, GOSUB’s and RESTORE wan’t work as designed, 


Lines 0-999! Line 10 sends you to the initialisation routine, Line 20 stores the hardware 
code for a null character in preparation for the keyboard scan routine at line 30. The 
scan routine constantly checks to see if a key has been pressed, If a valid key is 
pressed, the relevant routines from lines 40-90 will be carried out. If an invalid key is 
pressed, line 100 sends you back to the scan routine. 

Lines 1000-1999} Routines for increasing and decreasing the value of the background hue 
with "wraparound" for an out of limits condition. 

Lines 2000-2999) As above, but for background luminance, 

Lines 3000-39993 As above, but for lettering luminance, 

Lines 4000-4999} Updates all the colour registers whenever the "<" or ">" keys are pressed, 
Also provides some sound for audio feedback in place of the normal key-clicke The 
POKE in line 4000 sets the least significant byte of RTCLOK (the TV frame counter) to 
zeros Line 4010 ensures that 6/30ths of a second have elapsed before turning the 
sound off, as the time taken to do all the inbetween calculations varies depending on 
the current options in use. 

Lines 3000-5929! Updates the display of the current SETCOLOR values whenever they are 
being displayed. 

Lines 6000-6999; As above but for when the POKE values are being displayed, 

Lines 7000-7999! Changes the current option and modifies the display Gincluding the menu) to 
reflect this. Whenever the new description of the current option is shorter than the 
old description, it is necessary to blank out the portion of the old description that 
would "show through". 2 methods of doing this are used due to different circumstances, 
Line 7020 blanks out the whole of the old description before printing the new one, 
whereas line 7040 simply adds trailing blanks to the new description before printing it. 
Line 7030 is a simple string manipulation to centre the new description, 

Lines 8000-8999 Initialisation routine to disable the BREAK key, turn the cursor off, 
dimension the string, initialise variables and print the initial screen display. As this 
is only carried out once, it is tucked away at the end of the program. This is because 
every GOTO and GOSUB statement apparently finds the line to jump to by stepping 
through every line number from the start of the program. By shifting unnecessary lines 
from the beginning and having the most frequently used routines near the start, we can 
speed things up a bit. 
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1 REM THe HEHE HHA 


2 REM 4 by Garry Francis + 
a 
1 


REM # Published by Atari Computer # 
S REM 4 = Enthusiasts (N.S.W) 3 
& REM 4 furqust 1982 $ 
7 REM 433444473 HEH 
19 GOSUB 8000 
20 POKE 764,255 
30 X=PEEK(764) SIF X=255 THEN 30 
40 IF X=c4 THEN GOSUR OPTION+10:COSUB SETCOLR COTO SCAN 
50 IF X=55 THEN GOSUB OPTION+30:GOSUB SETCOLRSGOTO SCAN 


60 IF X=18 THEN GOSUE CHANCE!GOTO SCAN 
70 IF X=10 THEN DISPLAY=6090:GUSUB DISPLAY:GOTO SCAN 
80 IF X=62 THEN DISFLAY=5000:GOSUB DISFLAY:GOTO SCAN 
90 IF X=47 THEN POKE 744,255!POKE 82,2:GRAFHICS OSEND 
190 GOTO SCAN 
1000 DATA BACKGROUND HUE 
1010 HUE=HUE-11IF HUE<O THEN HUE=15 
1020 RETURN 
1030 HUESHUE+L{IF HUE215 THEN HUE=0 
1040 RETURN , 
2000 DATA BACKGROUND LUMINANCE 
2010 LUMEB=LUMB-23IF LUMB<0 THEN LUME=14 
2020 RETURN 
2030 LUMB=LUMB+2$IF LUHE>14 THEN LUME=0 
2040 RETURN 
3000 DATA LETTERING LUMINANCE 
3010 LUML=LUML-2$7F LUML<0 THEN LUML=14 
3020 RETURN 
3030 LUML=LUML+2¢7F LUML14 THEN LUML=0 
3040 RETURN 
4000 FOKE 20,0;SOUND 0,20,10,8:SETCOLOR 1,HUE,LUML{SETCOLOR 2,HUE,LUMB!SETCOLOR 4,HUE,LUMBIGOSUB DISPLAY 
4010 IF PEEK(20)<6 THEN 4010 
4020 SOUND 0,0,0,0SRETURN 
5000 POSITION 19,28? "SETCOLOR 1,"$HUE}","sLUML}" " 
5010 POSITION 19,43? "SETCOLOR 2,"}HUE}","$LUMB}" " 
5020 RETURN 
4000 POSITION 19,2$? "POKE 709,"$PEEK(709) 3" “ 
6010 POSITION 19,43? "POKE 710,"$PEEK(710)}" : 
6020 RETURN 
7000 OPTION=OFTION+10003IF OF TION:3000 THEN OPTION=1000 
7010 RESTORE OPTIONSREAD A¢ 
7020 POSITION 10,8:? " " 
7030 POSITION 20-LEN(A$)/2,8%? A$ 
7040 FOR T=LEN(A$)41 TO 2USA$(I,1)=" "{NEXT I 
7050 FOSITION 16,1317 A$ 
7060 POSITION 14,1537 A$ 
7070 RETURN 
8000 GRAPHICS OSFOKE 16,64$POKE 59774, 119SFOKE 752,1:DIM A$(21) 
8010 SCAN=200PTION=10003SETCOLR=4000 $DISPLAY=5000SCHANCE=7000SHUE=0 $LUMB=0LUML=14‘GO0SUB SETCOLR 
8020 POSITION 8,03? "CURRENT COLOUR VALUES " 
8030 POSITION 6,21? "LETTERING. ++." 
8040 POSITION 6,41? "BACKGROUND..."%GOSUE DISPLAY 
8050 POSITION 12,61? "CURRENT OPTION " 
8060 POSITION 13,8? "BACKGROUND HUE" 
8070 POSITION 17,11:? "MENU "SPOKE 87,5 
8080 ? $? "< DECREASE BACKGROUND HUE" 
8090 ? 3? "> INCREASE BACKGROUND HUE" 
8100 2 $% "C CHANGE CURRENT OPTION" 
8110 ? 3? "PB DISPLAY FOKE VALUES" 
8120 9 3? "S DISPLAY SETCOLOR VALUES" 
B130 2 3? "Q QUIT"}$RETURN 
= | 1 i 


PRINTING TEXT IN GRAPHICS 8 


by Gregg Ramsey Glustrations by Garry Francis) 


So you like programs do you? In this series of articles I will always give at least two 
programs and maybe a few more. If you like graphics, animation and sound then I’m sure 
you'll learn something from these articles. I aim to share some of my Findings about this 
incredible computer and a few ways of exploiting them. If you really want to learn 
something, then I advise you to read the program descriptions. They just might contain 
something that you didn’t know, 


When I first started programming my ATARI, I was impressed by its high resolution graphics 
capabilities - the BASIC PLOT, the “how would I get by without it" DRAWTO and the ever 
handy XIO fill, But the screen was too static for my liking and I couldn’t label or title my 
diagrams. In actual fact, GRAPHICS 8 is far from static, even in BASIC. In this article, we 
are going to discover one method for getting text onto your GRAPHICS & screen. A few short 
subroutines are all that’s needed to get upper and lower case, graphics characters or 
redefined characters, all in normal or inverse video anywhere on the screen: 


The first thing to do is to find where the display memory starts. This may be computed by 
the following expressiont 
1000 DMEM=FEEK (88)+256eFEEK (89) 

When we want to get characters printed to the screen, there are two things to think about - 
the character’s "shape table" in ROM (Read Only Memory) and it’s ATASCII value (ATARI 
version of American Standard Code for Information Interchange), When you type an "R" for 
example, the computer assigns the ATASCII value of &2, It then undergoes a conversion | 
process and ends up with a number defining its offset from the start of the character set in 
ROM, 


From here, an understanding of binary will help. In each memory location inside the ATARI, 
there are only 0’s and 1’s. A computer doesn’t understand numbers like 144, Instead, it 
would see it as 10100110, its binary equivalent. In decimal, each new column is a consecutive 
power of 10, but in binary, each new column is a consecutive power of 2 as shown in the 
diagram below! 


DECIMAL BINARY 


10° 107 07 101 10° 20, Qh QP gk 8 Be) gh 8 
10000 1000 100 10 1 128 64 32 46 8 4 2 1 
= (410000) (1x1000) +(7x100) + {0x10} + (3x1) = (1%128) (0x64) 4 (1x32) +(0 x16) 4 (0x8) 4 (4124)4 (4x2) + (Ox) 
= 41703 = 166 


Characters are defined and displayed in an & by 3 orid, 
For example, the letter "R" is shown on the right, 
The ATARI takes the top & bits (BInary digiTs) and 
where it sees a 1, it lights up the corresponding pixel 
(picture element). Where there is a 0, it retains the 
background colour, It then takes the next byte (& bits 
= 1 byte) and turns the pixels "on" or "off" according 
to the 1’s and 0’s in that byte, After examining 8 
bytes , the character is completed. Hence the decimal 
numbers defining the letter "R" are 0,124, 
102,107,124,108,102,0, 


2 = —> —) 
PSSGNC0OnN° 
NORNN & 





oe ee 


The shape table defining all the characters in the character set is stored in ROM beginning 
at memary location 57344 [E000], A table of the character set appears on page 55 of your 
BASIC REFERENCE MANUAL. For eee! the offset from the start of the character set 
for the letter "RE is 70, 


PROGRAM DESCRIPTIONS 

Listing 1 

Subroutine 1 (i.e, CONVERT) converts each ATASCII value toa character set offset and 
determines whether inverse is called for or not. It then PEEKs into the character set and 
stores the & bytes defining the character into the array CHAR, Subroutine Z (INVERSE) 
takes the elements in CHAR() and changes the decimal number, so that on a binary level, 
where there was once a0, there is now a1 and vice versa, Subroutine 3 (PRNTS) is the main 
part of the program. It sets up a variable D to point to the character’s starting location in 
display memory. (An excellent article that explains display memory is "ATARI GRAPHICS 
UNVEILED" in Creative Computing June and July, 1981, The display memory is basically an 
area in RAM which contains the information that is to appear on the screen display.) It then 
POKEs the shape values directly into the display memory and hey presto, instant letters in 
GRAPHICS &, Well, nearly instant. 


The program also has some extra editing and wraparound facilities ta make typing in 
GRAPHICS & possible, With a little more work you could add cursor control, To get lower 
case, graphics characters and inverse video, enter them the same as you would in GRAPHICS 
QO, The only real difference is that the RETURN key has been redefined so that instead of 
resuming typing on the next line, you will be asked to specify new X and Y co-ordinates, 


Line 100} Set up subroutine names. 

Line 110! Go to initialisation and picture drawing subroutines, 

Lines 120-190! Input and test the co-ordinates of the first letter to be printed. Notice that 
you can press BREAK to allow you to view the picture without bothering about any writing. 
Notice also that in line 170, the maximum value of Y is 19 as there are 4 lines of GRAPHICS 
Q at the bottom of the screen. Any errors will be trapped, 

Line Z00! Turn TRAP off and ensure characters are printed 3 scan lines apart, 

Line 240! Open the keyboard as an input device, 

Line 2503 Get one character and store its ATASCII value in the variable A, 

Line 240} Check to see if the RETURN key was pressed, 

Lines 770-300! One’s Fingers always slip, hence the back space utility to provide easy 
editing, 

Lines 330-240! The wraparound facility. Notice that if you go off the bottom of the screen; 
the next character printed will be on the left hand side of the top of the screens 

Line 250! When finished, go and get another character, 

Lines 7000-2040! Convert the ATASCII value to an offset from the start of the character 
set, Look for the shape table of that character in ROM and store the values in the array 
CHAR(, 

Lines 3000-2010! Since the ATARI doesn’t have inverse characters in ROM and if the flag is 
set in line 2000, alter the numbers in CHARO so that we get the letters in inverse, This is 
easier than you think and works because of the structure of binary numbers, 

Lines 4000-4020! Print the character by POKEing its shape directly into display memory. Its 
location in display memory is a function of PX and PY, 

Lines 5000-50203 Initialisation, BCS is the beginning of the character set and DM is the 
start of display memory, 

Lines 4000-4030! Draw the picture. You may delete these lines and insert your own picture 
anywhere from 6000 onwards, 


Listing 2 

If you think Listing 1 is too long and jazzy; or you only want to print upper case under 
program control, then Listing 2 does the trick quite nicely. The whole routine of conversion 
and printing is done in just a few lines. Type the program in, change my name to yours and 
watch the ease with which the letters appear next to or on top of your GRAPHICS 8 designs, 
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Lines 10-201 Select degrees mode, set colours, dimension A¢ and cet up variables, 

Line 30! Find display memory, 

Lines 40-50) Draw the picture, 

Lines 40-90) Declare PX and PY and go to the print subroutine, 

Line 1003 Endless loop to prevent the display fram clearing, Press BREAK to return to 
GRAPHICS 0, 

Lines 1000-1020) The print subroutine, It prints each character for the length of At by 
POKEing the character’s shape directly into display memory. (Remember that this only works 
For upper case-) C is the offset from the start of the character set, Dis the memory 
location to start POKEing the character, 


Listing 3 (A glimpse of things to come)! 
Did you know that your ATARI has more text modes than you can get at with the GRAPHICS 


command? These are often referred to as ANTIC modes, [See "What Makes It Tick?" in this 
issue for more about ANTIC - G.F.J By POKEing the right numbers into the right places, it 
is possible to program ANTIC to do your own thing, The extra text modes are the most 
exciting, because in two of them, the pixels that make up each character can have a different 
colour, just like in, say GRAPHICS 7, The one that is used in this program is ANTIC mode 4, 
where the characters are made in a 4 by & coloured grid. I will reveal the technical data when 
I have experimented a little more in the coming weeks, [At the time of writing, Gregg had 
only recieved the details of ANTIC mode 4 from me a mere 5 days ago and has already come 
up with this neat demo. Make sure you enter this program into your ATARI - you wan’t be 
disappointed! I look forward to seeing more of Gregg’s articles in future issues, - G.F.J 


Line 100} Disable BREAK key, If you didn’t do this, you would only get garbage on the 
screen when you tried to abort the program. Use SYSTEM RESET instead, 

Line 110: Set up Af for printing to the screen, 

Line 120: Find the beginning of the display list, 

Lines 130-1403 Change all ANTIC mode 2 entries (ive, GRAPHICS 0) to ANTIC mode 4, 

Lines 150-1703 Find somewhere to put the new character set and clear it out. 

Line 180} Change the pointer to the character set so that it points to our new character set 
instead of the one in ROM, 

Lines 190-200: Prints characters to the screen, although they are invisible at the moment, 
Lines 210-260; Changes character shapes randomly, checks to see if the space bar is pressed 
and changes the colour registers randomly, 

Lines 1000-1020! Prints A¢% to the screen in a neat pattern. 


Once the display gets going, you can stop it instantly by pressing the space bar. To restart 
the program where it left off, press any other key. This is achieved in line 720 by using the 
extremely handy register at memory location 744 [$02FC], Every time a key is pressed,a 
different number is stored in it, This number is completely different to the ATASCII cade 
numbers so enter the short program below to find out what they are. Notice that the space 


bar returns a 33, 
10 FRINT FPEEK(764)!:GOTO 10 


Analysing a program is one of the best ways to find out new tricks and is how I got to knowa 
lot of the things I know. Feel free to experiment, as this is another important method of 
learning. I shall try to devote a whole article to character graphics and now that we have 
coloured characters, there are strong possibilities for games and other detailed graphical 
presentations, 


Oh yes, you can have two graphics modes at the same time or 17 if it pleases you, It is all 
possible with custom display lists and I will probably end up writing an article on it if 
nobody else does, In the meantime, ask your friend with his almighty Apple to write a BASIC 
program under 1K that will do the same thing this program does and I’m sure he won’t feel so 
almighty anymore! [What’s an Apple? - G.F.] Anyway, happy ATARI-ing. 
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AA MESHES ESC OOSE SETI COTE SC OSS Sears £3 
Z FER 4.ISTING 1: TEXT IN GRAPHICS 84 
3 REM ¢ by Greag Reasey q 
4 REM 4 (Kodified by Carry Francis) ¢ 
5 REM # Published bu Atari Computer $ 
& REM # 9 Enthusiests (N.S.M.) + 
August 1982 3 


8 REM HAH A 


100 COMVERT=2000) INVERSE=3000 (PRNTS=4000: INITIAL=5000 


110 DRAWPIC=40063GQ5UB INITIAL‘GOSUE DRAWFIC 
120 TRAP 1Z0;PORE 752,0 

130 ? CHR$(125);"ENTER X START CO-ORDINATE (0-39)" 
140 2 37 "OR PRESS GREAK TO QUIT’ ;¢INPUT PX 
150 IF FX<0 OR FX99 GR PXCHINT(FX) THEN 130 
160 TRAP 160 

170 ? CHRS(125);"ENTER Y START CO-QRDINATE (0-19)" 
180 7? 3? "OR PRESS BREAK TQ QUIT"}SINFUT FY 
190 IF PY<0 OR FYD19 OR PYSSINT(PY) THEN 170 
Z00 TRAP 400003PY=FY*8POKE 752, 1 

210 ? CHR$(1Z5);"START WRITING!!!" 

220 7? $? "PRESS BACK S TO CORRECT MISTAKES" 
230 7 "OR RETURN TO SET NEW CO-ORDINATES"; 
240 OPEN #1,4,0,"K3" 

250 GET #1,A 

260 FLAGI=OtIF A=i55 THEN CLOSE #1:C0TO 120 
270 IF Av>124 THEN 310 

280 PX=PX-1LIF FX<0 THEN FX=39¢PY=FY-8 

290 IF PY<0 THEN FY=152 

300 FLAGI=1{A=32 

310 GOSUB CONVERTSGQSUB PRNTS 

320 IF FLAGI=1 THEN 250 

330 PX=PX+L30F PX239 THEN PX=0+PY=PY+8 

340 IF FY2i52 THEN FY=0 

350 GOTO 250 

1999 REM xxx ATASCIT TO CHARACTER SET OFFSET xxx 
2000 FLAGZ=03IF A127 THEN A=A-128°FLAG2=1 
2010 IF AX32 THEN A=A+é43C0T0 2030 

2020 IF A>=32 AND A<94 THEN A=A-32 

2030 C=BCS+AxB 

2040 FOR I=0 TO 7:CHAR(T)=PEEK(C+I) ¢NEXT I 
2050 IF FLAGZ=1 THEN GOSUE INVERSE 

2069 RETURN 

2999 REM soot INVERSE x0 

3000 FOR I=0 TO 7:CHAR(T)=255-CHAR(I) ‘NEXT I 
3010 RETURN 














3997 REM xxx PRINT CHARACTER TO GRAPHICS 8 SCREEN xxx 


4000 D=DM+PX+PYx40 
4010 FOR I=0 TO 7:FOKE D+1*40,CHAR(I) ‘NEXT I 
4020 RETURN 
4999 REM x4x INITIALISATION ¥xx 
5000 GRAPHICS 8:SETCOLOR 2, 
5010 DM=PEEK(88)+254¥*PEEK (89) 
3020 RETURN 
5999 REM xxx PICTURE DRAWING ROUTINE GOES HERE xxx 
6000 DEG tA=1460;E=80°COLOR 1 
6010 FOR D=) TO 360 STEF 2 

6020 PLOT A,ESDRANTO A+SOXSIN(2xD) ,B+70*C05(3xD) 
6030 NEXT DSRETURN 


0,0:DIM CHAR(7) BCS=57344 
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Ph eesdbiaaithhi 490347 4 
LISTING 23 SHELL DEMO? 
ty Cregg Ressey + 
Published by Atari Computer 4 
Enthosigsts (N.S H.) t 
August 1982 + 
THA BHABHA 
SETCOLOR 2,0,0:COLO 
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7 REM 
10 GRAPHICS G:DEG i 
Ri 

20 DIM A$(7)(A=1633 00 

30 DH=FEEK(88)+254XPEEK (89) 

40 FOR D=0 T0 349 STEP SiPLOT A,E 

30 DRAWTO At60aSIN(Ze) ,B+70x005(D) NE 
XT D 

60 PREL8SPY=3SAS="ShELL" GOSUE 1000 
70 FY=SOAS="BY..."SC0SUB 1000 

BO FY=100:A$="GREGG"SGOSUE 1000 

90 PRHI7{PY=L15SAS="RAMSEY !"SGOSUE 100 
0 

100 GOTO 100 

1000 FOR T=1 TO LEN(A$) 

1N40 C=57344+((ASC(A$(T, 1) )-32)8) 3D=D 
MtPX+PYR40+I-1 

1020 FOR J=0 TO 7tPOKE D+Je40,PEEK (Ct 
)INEXT J 

1030 NEXT I:RETURN 


REM HHH 

REM #LISTING 3: ANTIC MODE 4 DEMO 4 

REM # by Gregg Ramsey + 

REM ¥ (Modified by Garry Francis) # 

REM # Fublished by Atari Computer # 

Enthusiasts (NSeHed =F 
August 1982 $ 

8 REN BHAA 

100 GRAPHICS O3FOKE 16,64;P0KE 53774,1 

19 

110 DIM A$(90)tA$="EEEEEEFEEEEEDDDDDDDD 

EEDCCCCCCDEEDCEBEECDEEDCBAABCDEEDCBEBB 

CDEEDCCCCCCDEEDDDDDDDDEEEEEEEEEEE 

120 DL=PEEK(560)+256xPEEK (541) 

130 FOKE DL+3,48 

140 FOR I=DL+4 TO DL+28:POKE 1,43NEXT 

I 

150 A=PEEK (106)-83B=Ax256¢C=B+264 

160 FOR I=E 10 B+7{POKE I, 0:NEXT I 

170 FOR I=C TO C+39:POKE 1,03NEXT I 

180 FOKE 754,A 

190 Y=3:COSUB 1000 

200 Y=12:GOSUE 1000 

210 FOR I=C 10 (+39 

220 IF PEEK(764)=33 THEN 22 

230 FOKE T,RND(0)%255 

240 NEXT I 

Za0 FOR I=1 TO 200:NEXT I 

260 FOR I=0 TO 2:SETCOLOR I,RND(O)x16, 

RND(O)16:NEXT I 

270 GOTO 219 

1000 FOR X=5 TO 25 STEF 10 

1010 FOR I=0 TO StPOSITION X,Y+Ii? Ag( 

10xI+1,10xI+i0) 

1020 NEXT I$NEXT X}RETURN 
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News From Melbourne 
Thanks to an enthusiastic band of ATARI owners, things are really starting to happen in 
Australias There is also a users’ group in Victoria knawn as Melbourne Atari Computer 
Enthusiasts (or M,A.C.E, for short - but don’t confuse this with the very large Michigan 
A.C.E, in the U.S.A.) who began as a small group within K.A.0.S, (the 4502 Users’ Group), 
They have now broken away from K.A.O.5. and released their first newsletter called "The 
Australian ATARI Gazette". It includes news, rumours and 3 articles (including a vertical 
scrolling game by Stan Ockers) that previously appeared in the A.C.E, Newsletter, If you’d 
like further details, write to! 

Melbourne Atari Computer Enthusiasts 

P.O, Box 24é, 

Northcote, 

Victoria 3070 


Australian Magazine Devoted To ATARI 


Last issue I stressed the importance of returning your warranty card to Futuretronics, © 
Those who had done so before that issue have now received a complimentary issue of a new 
publication for ATARI owners called “Microprobe", It appears to be largely the work of one 
person named David Jones-Ellis and is sponsored by a shop in Melbourne called Calcutronics. 
The philosophy behind the magazine is that it is intended as a reference source that can be 
built upon with each issue, For this reason, it is a loose leaf format with pre-punched holes 
suitable for a 3-ring binder. It achieves its aim admirably and is highly recommended unless 
you’ve already got a multitude of references, The first issue was 4& pages and included 
articles on the console keys, player-missile graphics and an introduction to assembly 
language programming, The second issue has already been released and virtually continues 
on from the first issue, but has expanded to 44 pages!! Microprobe is to be released 
quarterly and may be obtained by sending a cheque or money order for $12.00 for 1 year’s 
subscription to} 

Microprobe 

2/41 Osborne Avenue, 

Glen Iris, 

Victoria 3144 


New Magazine On Computer Games 


On the subject of new magazines, issue #30 of SoftSide contained an advertisement for a new 
magazine called "Computer Gaming World" which will be released bi-monthly. The sample 
pages shown in the ad look quite interesting. Full details will be provided in a future Odds 
& Sods after we've received and reviewed the first issue, 





Even More Magazines! 


Mark Cator of the ATARI Users’ Group Support Program has sent us some forms for all 
members to fill out to enable them to be put on ATARI’s mailing list. If you haven‘t 
completed one of these forms yet, please contact Paul Phillips or myself immediately. The 
forms must be completely filled out and returned to ATARI in one batch, You will then 
recieve The ATARI Connection, ATARI Special Editions and ATARI Program Exchange 
Catalogue as they are released, And it’s free! Yet another good reason to join 
A.C.EUN.S.W)s 
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We have now received a support package from the ATARI Users’ Group Support Program, It 
consists of the Operating System source code listing, Disk Utility Package source code 
listing, ATARI Program Exchange catalogue (Spring edition 1982), ATARI Home Computer 
product catalogue and various other bits and pieces, These items are now in the reference 
library. The Operating System Users’ Manual and Hardware Manual were out of stock when 
the package was sent, but we hope to receive them at some time in the near future. The 
technical manuals have been given to us in good faith and we must respect ATARI’s copyright 
on them. For this reason, as well as to ensure that they are always available, it has been 
decided that publications cannot be copied or removed from the premises, so don’t embarrass 
us ar yourselves by asking, (If you consider it good enough to copy, then it’s good enough to 
buy. All technical manuals are now available at selected computer stores.) We will try to 
ensure that the publications are always available for personal perusal or research at each 
meeting, 


Competition for Users’ Group Logo 
Those present at the July meeting would be aware that the ATARI Users’ Group Support 


Program has announced a competition to find a logo that can be used by all ATARI users’ 
groups. Unfortunately, entries closed on ist August and we weren’t given sufficient notice 
to let you know about it, which is a pity, as ist prize includes The Communicator Kit, $350 
worth of access time on CompuServe and free membership and 10 hours of non-prime time 
access to Comp#U*Star. If you’ve got any ideas for a logo design, then Jet us know just the 
same; in case there is an extension of time. We’ll advise you of the results as soon as 
they’re announced, 


Debugging Hint 


Confucius say! "Man who claim he write computer program with no bugs is biggest liar this 
side of Great Wall of China". Confucius was obviously a very wise man, It’s almost 
impossible to write the first version of a program without at least one bug. Knowing that 
bugs exist is one thing, finding them is something else, Here is a simple routine which you 
may include in all new programs to help make the task easier, 

10 TRAP 1000 


t 


1008 GRAFHICS 0 

1010 ? “ERROR "$PEEK(195)3;" DETECTED AT FOLLOWING LINES" 

1020 LIST PEEK(186)+254xPEEK (187) 

1030 ? "RUN" SEND 
You can use whatever line numbers suit you, but make sure the TRAP is positioned early in 
the program or where it will catch all possible errors. In the example, when an error occurs 
control will be passed to line 1000. This prints an error message containing the error 
number, lists the line where it was detected, prints "RUN" and turns off sounds. The listed 
line may then be examined. If it contains an error, it may be corrected with the aid of the 
cursor control keys. Press RETURN to enter the corrected line. This will position the 
cursor over the word "RUN". Press RETURN again and the program will re-start. If the 
error was not in the listed line, then it may at least supply a hint as to where the error 
occurred and you can try to find it in the usual manner. When the program is fully debugged, 
you can delete the debugging lines and everything should be hunky dory, 


Next Issue 

Last issue I promised to have a look at the ATARI’s hardware and the differences between 
NTSC and PAL. They turned out to be long enough to warrant articles of their own and may 
be found elsewhere in this issue. Don’t forget to contact me if you’ve got any hints, tips, 
questions or suggestions for the column +. or criticisms either for that matter. Next issue 
should be a doozy. Most of it will be taken up by our special feature on the GTIA chip (see 
the Editorial for further details). If there’s any room left over I might take a look at the 
ATARI’s attract mode, Bye ‘til then. 
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NTSC vs PAL 


by Garry Francis 


Unless you hook it up directly to your brain, a computer needs some way to convey 
information to the user. A printer or panel of flashing lights could be used, but the most 
common method is to incorporate some form of video display, 


The ATARI 400/300 was probably the first truly consumer oriented computer ever made, As 
such, it was designed to utilise an ordinary television receiver as its video display. This 
had the advantage of being cheap and readily available (most people already own a TV), but 
with the additional benefits of colour and sound at no extra cost, The physical limitations of 
the ATARI’s display are therefore directly related to the system used to generate the 
television display, The system used in U.S.A. is known as NTSC (which stands for National 
Television System Committee), however Australia uses a different system known as PAL 
(Phase Alternating Line), What this all boils down to is that there are actually Z different 
versions of the ATARI. We will always refer to these as the NTSC version (used in U.S.A.) 
and the PAL version (used in Australia), Most PAL hardware is identified by a white sticker 
with the letter "P" on the packing carton and/or on the unit itself, 


Programs will usually run without modification on either system, sa the differences between 
the two can generally be ignored. However, there are occasions when the user needs to be 
aware of some of the differences, particularly if using a time dependant program (ike a real 
time clock) or if writing software for the overseas market, A program can determine which 
version of the machine is being used by reading the hardware register PAL at location 53268 
([$D014], Bit 0 is not used, but it is always logic true (ie. a value of 1) on my computer. 
Bits 1, 2 and 3 will be logic true for NTSC and logic false (ive. a value of 0) for PAL, Bits 4 
to 7 are not used. 


The main difference between the 2 versions is in the screen refresh rate, i.e, how frequently 
the raster scan television image is "redrawn", This is done &0 times per second on the NTSC 
version but the PAL version has a slower rate of 50 times per second. This is reflected by 
the TV frame counter RTCLOK at memory locations 18-20 [$12-$141, (Note that unlike the 
usual arrangement of multi-byte numbers on the 6502, RTCLOK is stored with the most 
significant byte first and the least significant byte last.) RTCLOK is incremented every 
vertical blank, i.e. the period during which the electron beam is returning to the top of the 
screen in preparation for the next frame, As RTCLOK is often used in programs requiring a 
real-time clock, the different screen refresh rates must be kept in mind. For example, when 
typing in a program from a U.S, magazine, you may come across a line something like this! 
TIME = (PEEK(20) + 2546*PEEK(19) + 65536KPEEK(18))/60 

This will find some elapsed time in seconds on the NTSC version of the ATARI, but you would 
have to modify it to multiply by 50 instead of 60 if you wish to retain the correct time for 
the PAL version, 


The remainder of this section is for the technically minded. 
NTSC has 262 scan lines per TV frame, whereas PAL has 312 scan lines per frame. The 
hardware compensates for this by adding extra blank lines at the top and bottom of the 


screen so that display lists do not have to be altered, 


It is said that a hardware modification has ensured that NTSC and PAL colours are similar, 
but having never seen an NTSC display, I can’t comment on how true this is, 


The 6502B microprocessor in the NTSC version runs at a rate of 1.79? MHz. In order to 
maintain one CPU cycle per colour clock, the PAL version has a 6502C capable of 3 MHz, 


Apparently there are changes in the POKEY chip to cater for differences in cassette 


handling. I’m not sure what this is all about, but is somehow related to cassette 
input/output being tied to VCOUNT (the count of TV scan lines) for timing or checksums. The 


PAL and NTSC Operating Systems are slightly different because of this, The PAL version 
may be identified by its Part No. CX&01-P, Note that if you’ve bought the Operating System 
source code listing that it is for the NTSC version, but differences are minimal. 


Just as an afterthought, you may be interested to know that Australia is not the only 
country using the PAL system, World leaders such as Algeria, Bahrain, Ghana, Iceland, 
Jordan, Kuwait, Portugal, SINGAPORE (hint, hint), Tanzania, oat and many others also 
use the s same system, 


i? 
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RULES FOR PROGRAMMERS 


Any given program, when running, is obsolete, 


Any given program costs more and takes longer to write than even the best 
estimate. 


If a program is useful, it will have to be changed. 
If a program is useless, it will have to be documented. 
Any program will expand to fill all available memory. 


The value of a program is directly proportional to the weight of its 
output. 


Program complexity grows until it exceeds the capability of the programmer 
who must maintain it. 


If atest installation functions perfectly, all subsequent systems will 
malfunction. 


Not until a program has been in production for at least six months will 
the most harmful error be detected. 


Job control cards that cannot be misarranged will be. 
Interchangable tapes won't. 


If the input editor has been designed to reject all bad input, some 
ingenious idiot will determine a way to get data past it. 


Any system which depends on human reliability is unreliable: 


Undetectable errors are infinite in nature, in contrast to detectable 
errors, which by definition are finite. 


There is always one more bug. 
Build a system that even a fool can use and only a fool will want to. 
Variables won't, constants aren't. 


Once you have exhausted all possibilities, and fail, there will be one 
solution, simple and obvious, highly visible to everyone else. 
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[WAIT HO MORE FOR ATARI SOFTWARE” 








“= HAVE 


W TART 
PROGRAMS FOR FUN, 
BUSINESS, EDUCATION 
& PROGRAMMING AIDS 


We also sell COMPUTE! and 
ANTIC and know ATARI best 





FILEMANAGER 800 
e Up to 2000 char. per record 
e Powerful search functions 


e Mailing list and lots more 


COMPUMAX from $199.00 
Ledger — Inventory — Debtors 


VISICALC 


LETTER PERFECT 
Powerful W.P. system $199.00 


We accept Bankcard, American 


Andromeda 
Asteroids 
Bug Attack 


Caverns of Mars 


Crossfire 
‘Dodge Racer 
Dung Beetle 
Galatic Chase 
Ghost Hunter 
Hockey 

Space Invaders 
Star Raiders 


Express, or use 


a MYER Account - MAIL ORDERS INVITED 
LOWER GROUND FLOOR, *swerm SYDNEY STORE, GEORGE & MARKET STREETS. 


SYDNEY TELEPHONE 238-9984 


ACTION GAMES 


Jawbreaker 
Match Racer 
Missile Command 
Mouskattack 

Poo! 1.5 
Protector 

Race in Space 
Raster Blaster 


















Ali Baba 
Adventure 

B1 Bomber 
Captivity 

Conflict 2000 
Eastern Front 
Galactic Empire 
Lords of Kharma 
Midway Campaign 
Rescue at Rigel 
Waterloo 


ATARI FOR 
EDUCATION 


My ist Alphabet 


E Analogies 


Compumath/Read 


Intro to Programming 


Piano Player 
Preschool Two 


Reading Comprehension 


Program Tutorials 


# Number Series 


Vocubulary 1 & 2 
OS+A Basic 


Lisp 

Memory Maps 
New Utilities 
3D Graphics 
Tach-master 
Teachers Pack 


HAROWARE 


10 Keypad 
Monkey Wrench 
Le Stick 


Echo Speech 
Synthesisor 
Macro Interface 


Double Density, 
Disc 
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